Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.rmi
Class MarshalledObject

    java.lang.Object
      |
      +--java.rmi.MarshalledObject

All Implemented Interfaces:
  Serializable

public final class MarshalledObject
extends Object
implements Serializable

A `MarshalledObject` contains a byte stream with the serialized representation of an object given to its constructor. The `get` method returns a new copy of the original object, as deserialized from the contained byte stream. The contained object is serialized and deserialized with the same serialization semantics used for marshaling and unmarshaling parameters and return values of RMI calls: When the serialized form is created:

- classes are annotated with a codebase URL from where the class can be loaded (if available), and
- any remote object in the `MarshalledObject` is represented by a serialized instance of its stub.

When copy of the object is retrieved (via the `get` method), if the class is not available locally, it will be loaded from the appropriate location (specified the URL annotated with the class descriptor when the class was serialized.

`MarshalledObject` facilitates passing objects in RMI calls that are not automatically deserialized immediately by the remote peer.

Since:
  1.2
See Also:
  Serialized Form

Constructor Summary
`MarshalledObject(Object obj)` Creates a new `MarshalledObject` that contains the serialized representation of the current state of the supplied object.

Method Summary
`boolean` | `equals(Object obj)` Compares this `MarshalledObject` to another object.
`Object` | `get()` Returns a new copy of the contained marshalledobject.
`int` | `hashCode()` Return a hash code for this `MarshalledObject`.

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### MarshalledObject

    public MarshalledObject(Object obj)
                     throws IOException

  Creates a new `MarshalledObject` that contains the serialized representation of the current state of the supplied object. The object is serialized with the semantics used for marshaling parameters for RMI calls.

Parameters:
  `obj` - the object to be serialized (must be serializable)
Throws:
  `IOException` - if an `IOException` occurs; an `IOException` may occur if `obj` is not serializable.
Since:
  1.2

Method Detail

### get

    public Object get()
               throws IOException,
                      ClassNotFoundException

  Returns a new copy of the contained marshalledobject. The internal representation is deserialized with the semantics used for unmarshaling paramters for RMI calls.

  Returns:
    a copy of the contained object
  Throws:
    `IOException` - if an `IOException` occurs while deserializing the object from its internal representation.
    `ClassNotFoundException` - if a `ClassNotFoundException` occurs while deserializing the object from its internal representation. could not be found
  Since:
    1.2

### hashCode

    public int hashCode()

  Return a hash code for this `MarshalledObject`.

  Overrides:
    `hashCode` in class `Object`
  Returns:
    a hash code
  See Also:
    `Object.equals(java.lang.Object)`, `Hashtable`

### equals

    public boolean equals(Object obj)

  Compares this `MarshalledObject` to another object. Returns true if and only if the argument refers to a `MarshalledObject` that contains exactly the same serialized representation of an object as this one does. The comparison ignores any class codebase annotation, meaning that two objects are equivalent if they have the same serialized representation except for the codebase of each class in the serialized representation.

  Overrides:
    `equals` in class `Object`
  Parameters:
    `obj` - the object to compare with this `MarshalledObject`
  Returns:
    `true` if the argument contains an equaivalent serialized object; `false` otherwise
  Since:
    1.2
See Also:
  `Object.hashCode()`, `Hashtable`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.